home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / biblio / tib / NONUNIX < prev    next >
Text File  |  1989-03-28  |  4KB  |  72 lines
  1. 1. If the unix command dd is unavailable, note the tape parameters in
  2.    INSTALL.  Use your tape dump.  The "if" is the input name (tape unit);
  3.    the "of" is the output name.; "ibs" is input block size (default 512).
  4.    (In particular, dd is no good for ANSI tapes.)
  5.  
  6. 2. All file names are eight letters or less with an .extension of
  7.    three or less letters.  Most variables are six or less letters; in any 
  8.    case, the first six letters determine the variables.  Also there are both
  9.    caps and lower-case letters used, in file names, but if they are all made
  10.    one case, there is no conflict.
  11.  
  12. 3. The program outfname in tibargs.c creates an output file name of the form
  13.            file-t.tex
  14.    or
  15.            file.ref-t.tex
  16.    for tib and tiblist.  If this is illegal change the code in the routine
  17.    `outfname' in tibargs.c appropriately (maybe look for the last `.' in
  18.    the name and add extension).
  19.  
  20.                              *** WARNING ***
  21.    If your system has a limit on the length of file names and/or extensions
  22.    and silently truncates ones that are too long, there is a danger that tib
  23.    or tiblist could overwrite existing input files.  The subroutine `outfname'
  24.    should be rewritten to prevent this possibility.  One way, although
  25.    somewhat inconvenient for the user, is to give the output a different
  26.    extension.  A second way, also possibly inconvenient, is to test for the
  27.    existence of a file with the proposed name before opening the file.
  28.    If your system will not open an open file, it would be possible to delay
  29.    closing the input file (fclose(fd)) until the end of the run, although
  30.    this is not necessarily 100% safe, since for example tiblist could take
  31.    `test.ref' as input and overwrite `test.tex' as output.  The author assumes
  32.    no responsibility for overwritten files.
  33.  
  34. 4. The directory separator character is '/' for unix.  If this is not
  35.    your separator character, make appropriate changes in tib.h and
  36.    at the top of tibargs.c in <sys/types.h> and <sys/stat.h>.
  37.    Also redefine \DIRSEP at the beginning of tibdoc.tex.  Similarly,
  38.    the option character on the program calls is '-' for unix.  If this
  39.    is not your option character, make appropriate changes in tib.h
  40.    and redefine \OPTCH in tibdoc.tex.
  41.  
  42. 5. The routine qsort is used several places.  If qsort is unavailable,
  43.    an equivalent routine should be used.
  44.  
  45. 6. Tibdex uses a unix routine sort.  If sort is unavailable, see the
  46.    discussion at the beginning of tibdex.c.
  47.  
  48. 7. The files <sys/types.h> and <sys/stat.h> are used in the routine
  49.    chkindex in tibargs.c in an error check.  If they are unavailable,
  50.    rewrite chkindex to do nothing but return.
  51.  
  52. 8. If make is unavailable, compile and link the programs as indicated:
  53.       tibdex requires tibdex, streams, makekey;
  54.       tiblook requires tiblook, locate, seek, streams, makekey;
  55.       tiblist requires tiblist, tibargs, streams, makekey;
  56.       tib requires tib, tibargs, locate, seek, streams, makekey.
  57.  
  58. 9. If everything else seems OK and Tib gives lots of "no references found"
  59.    or "multiple references found", it may be counting end-of-line or new-line
  60.    characters differently.  Make your counting unix compatible or some other
  61.    fix.
  62.  
  63. 10. The file tib.man is for a unix manual file and can be discarded.
  64.  
  65. 11. Remark.  Word-definition pairs are read into memory one at a time, and
  66.   are sorted as they are read.  For large sorted files of such pairs (such
  67.   as amsabb.ttz, amsfll.ttz), this is a rather inefficient way to do things
  68.   (it will be reworked in a future version), and may be unacceptable for
  69.   your system.  It may be preferable to either a) rewrite the appropriate
  70.   code (case 'D' in tibargs.c), or b) not use large files of such pairs.  Most
  71.   of the time at the beginning of a run of tib is used processing these pairs.
  72.